home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cato / Xm / MrmFetchWidget.z / MrmFetchWidget
Encoding:
Text File  |  1998-10-20  |  6.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt - Fetches and creates any indexed (UIL named)
  10.           application widgets and its children
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<MMMMrrrrmmmm////MMMMrrrrmmmmPPPPuuuubbbblllliiiicccc....hhhh>>>>
  14.  
  15.           CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt((((_h_i_e_r_a_r_c_h_y__i_d, _i_n_d_e_x, _p_a_r_e_n_t__w_i_d_g_e_t, _w_i_d_g_e_t, _c_l_a_s_s))))
  16.                MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy_h_i_e_r_a_r_c_h_y__i_d;;;;
  17.                SSSSttttrrrriiiinnnngggg    _i_n_d_e_x;;;;
  18.                WWWWiiiiddddggggeeeetttt    _p_a_r_e_n_t__w_i_d_g_e_t;;;;
  19.                WWWWiiiiddddggggeeeetttt    ****_w_i_d_g_e_t;;;;
  20.                MMMMrrrrmmmmTTTTyyyyppppeeee   ****_c_l_a_s_s;;;;
  21.  
  22.  
  23.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  24.           This page documents version 1.2 of the Motif library.
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.           The MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt function fetches and creates an indexed
  28.           application widget and its children.  The indexed
  29.           application widget is any widget that is named in UIL.  In
  30.           fetch operations, the fetched widget's subtree is also
  31.           fetched and created.  This widget must not appear as the
  32.           child of a widget within its own subtree. MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt
  33.           does not execute XXXXttttMMMMaaaannnnaaaaggggeeeeCCCChhhhiiiilllldddd for the newly created widget.
  34.  
  35.  
  36.           _h_i_e_r_a_r_c_h_y__i_dSpecifies the ID of the uuuuiiiidddd hierarchy that
  37.                       contains the interface definition.  The
  38.                       _h_i_e_r_a_r_c_h_y__i_d was returned in a previous call to
  39.                       MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
  40.  
  41.           _i_n_d_e_x       Specifies the UIL name of the widget to fetch.
  42.  
  43.           _p_a_r_e_n_t__w_i_d_g_e_t
  44.                       Specifies the parent widget ID.
  45.  
  46.           _w_i_d_g_e_t      Returns the widget ID of the created widget.
  47.  
  48.           _c_l_a_s_s       Returns the class code identifying MRM's widget
  49.                       class.  The widget class code for the main
  50.                       window widget, for example, is MMMMRRRRMMMMwwwwccccMMMMaaaaiiiinnnnWWWWiiiinnnnddddoooowwww.
  51.                       Literals identifying MRM widget class codes are
  52.                       defined in MMMMrrrrmmmm....hhhh.
  53.  
  54.  
  55.           An application can fetch any named widget in the uuuuiiiidddd
  56.           hierarchy using MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt.  MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt can be
  57.           called at any time to fetch a widget that was not fetched at
  58.           application startup.  MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt can be used to defer
  59.           fetching pop-up widgets until they are first referenced
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           (presumably in a callback), and then used to fetch them
  75.           once.
  76.  
  77.           MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt can also create multiple instances of a
  78.           widget (and its subtree).  In this case, the uuuuiiiidddd definition
  79.           functions as a template; a widget definition can be fetched
  80.           any number of times.  An application can use this to make
  81.           multiple instances of a widget, for example, in a dialog box
  82.           box or menu.
  83.  
  84.           The index (UIL name) that identifies the widget must be
  85.           known to the application.
  86.  
  87.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  88.           This function returns one of these status return constants:
  89.  
  90.  
  91.           MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS          The function executed successfully.
  92.  
  93.           MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY    The hierarchy ID was invalid.
  94.  
  95.           MMMMrrrrmmmmNNNNOOOOTTTT____FFFFOOOOUUUUNNNNDDDD        The widget was not found in UID
  96.                               hierarchy.
  97.  
  98.           MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE          The function failed.
  99.  
  100.  
  101.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  102.           MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy((((3333XXXX)))), MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee((((3333XXXX)))).
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.